home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / libblas / asum.z / asum
Encoding:
Text File  |  2002-10-03  |  3.0 KB  |  89 lines
  1. ASUM(3F)                                              Last changed: 11-2-98
  2.  
  3.  
  4. NNAAMMEE
  5.      SSAASSUUMM, DDAASSUUMM, SSCCAASSUUMM, DDZZAASSUUMM - Sums the absolute value of elements in
  6.      a real or complex vector
  7.  
  8. SSYYNNOOPPSSIISS
  9.      Real
  10.  
  11.         _s_u_m == SSAASSUUMM ((_n,, _x,, _i_n_c_x))
  12.  
  13.      Double precision
  14.  
  15.         _s_u_m == DDAASSUUMM ((_n,, _x,, _i_n_c_x))
  16.  
  17.      Complex
  18.  
  19.         _s_u_m == SSCCAASSUUMM ((_n,, _x,, _i_n_c_x))
  20.  
  21.      Double complex
  22.  
  23.         _s_u_m == DDZZAASSUUMM ((_n,, _x,, _i_n_c_x))
  24.  
  25. IIMMPPLLEEMMEENNTTAATTIIOONN
  26.      IRIX systems
  27.  
  28. DDEESSCCRRIIPPTTIIOONN
  29.      SSAASSUUMM and DDAASSUUMM sum the absolute values of the elements of a real
  30.      vector, as follows:
  31.  
  32.                                 n
  33.                sum <- ||x||  = Sum |x |
  34.                            1   i=1   i
  35.  
  36.      where _x is a real vector of length _n.
  37.  
  38.      SSCCAASSUUMM and DDZZAASSUUMM sum the absolute values of the real and imaginary
  39.      parts of the elements of a complex vector, as follows:
  40.  
  41.  
  42.  
  43.                sum <- ||Real(x)||  + Imag(x)|| =
  44.                                  1            1
  45.                        n                n
  46.                       Sum |Real(x )| + Sum |Imag(x )|
  47.                       i=1        i     j=1        j
  48.  
  49.      where _x is a complex vector of length _n.
  50.  
  51.      These functions have the following arguments:
  52.  
  53.      _s_u_m       Sum of values.
  54.                SSAASSUUMM: Real sum of the absolute values of the elements of _x.
  55.                DDAASSUUMM: Double precision sum of the absolute values of the
  56.                elements of _x.
  57.                SSCCAASSUUMM: Real sum of the absolute values of the real and
  58.                imaginary parts of the elements of _x.
  59.                DDZZAASSUUMM: Double precision sum of the absolute values of the
  60.                real and imaginary parts of the elements of _x.
  61.  
  62.      _n         Integer.  (input)
  63.                Number of elements in the vector to be summed.  If _n <= 0,
  64.                these routines return 0.
  65.  
  66.      _x         Array of dimension (_n-1) * |_i_n_c_x| + 1. (input)
  67.                SSAASSUUMM: Real array.
  68.                DDAASSUUMM: Double precision array.
  69.                SSCCAASSUUMM: Complex array.
  70.                DDZZAASSUUMM:  Double complex array.
  71.  
  72.                Array _x contains the vector to be summed.
  73.  
  74.      _i_n_c_x      Integer.  (input)
  75.                Increment between elements of _x.  If _i_n_c_x = 0, the results
  76.                will be unpredictable.
  77.  
  78. NNOOTTEESS
  79.      These routines are Level 1 Basic Linear Algebra Subprograms (Level 1
  80.      BLAS).
  81.  
  82.      When working backward (_i_n_c_x < 0), each routine starts at the end of
  83.      the vector and moves backward, as follows:
  84.  
  85.           _x(1-_i_n_c_x * (_n-1)), _x(1-_i_n_c_x * (_n-2)), ..., _x(1)
  86.  
  87. SSEEEE AALLSSOO
  88.      This man page is available only online.
  89.